TranslateFile

TranslateFile
Header:	Translation.h		Carbon status:	Supported

Translates a document from one format to another.

OSErr TranslateFile (
    const FSSpec *sourceDocument, 
    const FSSpec *destinationDocument, 
    const FileTranslationSpec *howToTranslate
);

sourceDocument: A pointer to the document to translate.
destinationDocument: A pointer to the file to put the translated document into. Note that your application only specifies the name and location for the file; the function creates the file and puts the translated data into it. The destination file must not exist before you call this function.
howToTranslate: A pointer to a buffer of information indicating how to translate the document. Usually, you’ll get this information by calling the CanDocBeOpened function.

function result: A result code.

SPECIAL CONSIDERATIONS

This function might cause memory to be moved or purged; you should not call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when Translation 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by Translation 1.0 and later.